<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Symbian/S60 Camera Wrapper Library: cameraengine.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.7.1 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li id="searchli">
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
    </ul>
  </div>
<div class="header">
  <div class="headertitle">
<h1>cameraengine.h</h1>  </div>
</div>
<div class="contents">
<a href="cameraengine_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment">* ============================================================================</span>
<a name="l00003"></a>00003 <span class="comment">*  Name        : cameraengine.h</span>
<a name="l00004"></a>00004 <span class="comment">*  Part of     : Symbian/S60 Camera Wrapper</span>
<a name="l00005"></a>00005 <span class="comment">*  Description : Camera engine class declaration</span>
<a name="l00006"></a>00006 <span class="comment">*  Version     : %version: 2 %</span>
<a name="l00007"></a>00007 <span class="comment">*</span>
<a name="l00008"></a>00008 <span class="comment">* This program is free software. It comes without any warranty, to</span>
<a name="l00009"></a>00009 <span class="comment">* the extent permitted by applicable law. You can redistribute it</span>
<a name="l00010"></a>00010 <span class="comment">* and/or modify it under the terms of the Do What The Fuck You Want</span>
<a name="l00011"></a>00011 <span class="comment">* To Public License, Version 2, as published by Sam Hocevar. See</span>
<a name="l00012"></a>00012 <span class="comment">* http://sam.zoy.org/wtfpl/COPYING for more details.</span>
<a name="l00013"></a>00013 <span class="comment">*</span>
<a name="l00014"></a>00014 <span class="comment">* You are welcome to, but not required to, contribute any modifications that</span>
<a name="l00015"></a>00015 <span class="comment">* improve stability, usability and/or feature set of the library back to</span>
<a name="l00016"></a>00016 <span class="comment">* Symbian/S60 Camera Wrapper project, as long as binary compatibility is</span>
<a name="l00017"></a>00017 <span class="comment">* retained. See https://projects.forum.nokia.com/camerawrapper for more info.</span>
<a name="l00018"></a>00018 <span class="comment">* ============================================================================</span>
<a name="l00019"></a>00019 <span class="comment">*/</span>
<a name="l00020"></a>00020 
<a name="l00023"></a>00023 <span class="preprocessor">#ifndef CCAMERAENGINE_H</span>
<a name="l00024"></a>00024 <span class="preprocessor"></span><span class="preprocessor">#define CCAMERAENGINE_H</span>
<a name="l00025"></a>00025 <span class="preprocessor"></span>
<a name="l00026"></a>00026 <span class="comment">// INCLUDES</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &lt;e32base.h&gt;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;ecam.h&gt;</span>
<a name="l00029"></a>00029 
<a name="l00030"></a>00030 <span class="comment">// FORWARD DECLARATIONS</span>
<a name="l00031"></a>00031 <span class="keyword">class </span><a class="code" href="class_c_camera_engine_private.html" title="Camera engine (implementation) class.">CCameraEnginePrivate</a>;
<a name="l00032"></a>00032 <span class="keyword">class </span><a class="code" href="class_m_camera_engine_observer.html" title="Camera engine observer interface (pure virtual).">MCameraEngineObserver</a>;
<a name="l00033"></a>00033 <span class="keyword">class </span>CCameraAdvancedSettings;
<a name="l00034"></a>00034 
<a name="l00035"></a>00035 <span class="preprocessor">#ifdef DOXYGEN</span>
<a name="l00036"></a>00036 <span class="preprocessor"></span><span class="preprocessor">#define NONSHARABLE_CLASS(X) class X</span>
<a name="l00037"></a>00037 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00038"></a>00038 <span class="preprocessor"></span>
<a name="l00042"></a><a class="code" href="class_c_camera_engine.html">00042</a> NONSHARABLE_CLASS( <a class="code" href="class_c_camera_engine.html" title="Camera engine class.">CCameraEngine</a> ) : public CBase
<a name="l00043"></a>00043   {
<a name="l00044"></a>00044 <span class="keyword">public</span>:
<a name="l00045"></a>00045 
<a name="l00050"></a><a class="code" href="class_c_camera_engine.html#a0d9a8a204197476c630edf136c2dceed">00050</a>   <span class="keyword">enum</span> <a class="code" href="class_c_camera_engine.html#a0d9a8a204197476c630edf136c2dceed" title="Enumeration for possible camera engine states.">TCameraEngineState</a>
<a name="l00051"></a>00051       {
<a name="l00052"></a>00052       EEngineNotReady,
<a name="l00053"></a>00053       EEngineIdle,
<a name="l00054"></a>00054       EEngineViewFinding,
<a name="l00055"></a>00055       EEngineCapturing,
<a name="l00056"></a>00056       EEngineFocusing
<a name="l00057"></a>00057       };
<a name="l00058"></a>00058 
<a name="l00071"></a>00071   IMPORT_C <span class="keyword">static</span> <a class="code" href="class_c_camera_engine.html" title="Camera engine class.">CCameraEngine</a>* NewL( TInt aCameraHandle, 
<a name="l00072"></a>00072                                        TInt aPriority, 
<a name="l00073"></a>00073                                        <a class="code" href="class_m_camera_engine_observer.html" title="Camera engine observer interface (pure virtual).">MCameraEngineObserver</a>* aObserver );
<a name="l00077"></a>00077   IMPORT_C ~<a class="code" href="class_c_camera_engine.html" title="Camera engine class.">CCameraEngine</a>();
<a name="l00078"></a>00078   
<a name="l00079"></a>00079 <span class="keyword">public</span>:
<a name="l00080"></a>00080 
<a name="l00084"></a>00084   IMPORT_C TCameraEngineState State() <span class="keyword">const</span>;
<a name="l00085"></a>00085 
<a name="l00090"></a>00090   IMPORT_C TBool IsCameraReady() <span class="keyword">const</span>;
<a name="l00091"></a>00091 
<a name="l00095"></a>00095   IMPORT_C TBool IsAutoFocusSupported() <span class="keyword">const</span>;
<a name="l00096"></a>00096   
<a name="l00104"></a>00104   IMPORT_C <span class="keywordtype">void</span> CaptureL();
<a name="l00105"></a>00105   
<a name="l00111"></a>00111   IMPORT_C <span class="keywordtype">void</span> ReserveAndPowerOn();
<a name="l00112"></a>00112 
<a name="l00117"></a>00117   IMPORT_C <span class="keywordtype">void</span> ReleaseAndPowerOff();
<a name="l00118"></a>00118 
<a name="l00128"></a>00128   IMPORT_C <span class="keywordtype">void</span> PrepareL( TSize&amp; aCaptureSize,               
<a name="l00129"></a>00129       CCamera::TFormat aFormat = CCamera::EFormatExif );
<a name="l00130"></a>00130       
<a name="l00140"></a>00140   IMPORT_C <span class="keywordtype">void</span> StartViewFinderL( TSize&amp; aSize );
<a name="l00141"></a>00141 
<a name="l00145"></a>00145   IMPORT_C <span class="keywordtype">void</span> StopViewFinder();
<a name="l00146"></a>00146   
<a name="l00152"></a>00152   IMPORT_C <span class="keywordtype">void</span> ReleaseViewFinderBuffer();
<a name="l00153"></a>00153   
<a name="l00160"></a>00160   IMPORT_C <span class="keywordtype">void</span> ReleaseImageBuffer();
<a name="l00161"></a>00161   
<a name="l00168"></a>00168   IMPORT_C <span class="keywordtype">void</span> StartFocusL();
<a name="l00169"></a>00169   
<a name="l00173"></a>00173   IMPORT_C <span class="keywordtype">void</span> FocusCancel();
<a name="l00174"></a>00174 
<a name="l00184"></a>00184   IMPORT_C <span class="keywordtype">void</span> SupportedFocusRanges( TInt&amp; aSupportedRanges ) <span class="keyword">const</span>;
<a name="l00185"></a>00185   
<a name="l00191"></a>00191   IMPORT_C <span class="keywordtype">void</span> SetFocusRange( TInt aFocusRange );
<a name="l00192"></a>00192   
<a name="l00200"></a>00200   IMPORT_C CCamera* Camera();
<a name="l00201"></a>00201   
<a name="l00210"></a>00210   IMPORT_C CCamera::CCameraAdvancedSettings* AdvancedSettings();
<a name="l00211"></a>00211   
<a name="l00218"></a>00218   IMPORT_C <span class="keyword">static</span> TInt CamerasAvailable();
<a name="l00219"></a>00219   
<a name="l00224"></a>00224   IMPORT_C TInt MaxDigitalZoom();
<a name="l00225"></a>00225   
<a name="l00230"></a>00230   IMPORT_C TInt DigitalZoom();
<a name="l00231"></a>00231   
<a name="l00238"></a>00238   IMPORT_C TInt AdjustDigitalZoom( TBool aTele );
<a name="l00239"></a>00239   
<a name="l00245"></a>00245   IMPORT_C TInt SupportedExposureModes();
<a name="l00246"></a>00246   
<a name="l00251"></a>00251   IMPORT_C TInt Exposure();
<a name="l00252"></a>00252   
<a name="l00259"></a>00259   IMPORT_C TInt SetExposure( TInt aExposure );
<a name="l00260"></a>00260 
<a name="l00265"></a>00265   IMPORT_C TInt SupportedFlashModes();
<a name="l00266"></a>00266   
<a name="l00271"></a>00271   IMPORT_C TInt Flash();
<a name="l00272"></a>00272 
<a name="l00279"></a>00279   IMPORT_C TInt SetFlash( TInt aFlash );
<a name="l00280"></a>00280 
<a name="l00281"></a>00281 <span class="keyword">protected</span>:
<a name="l00282"></a>00282     <a class="code" href="class_c_camera_engine.html" title="Camera engine class.">CCameraEngine</a>();
<a name="l00283"></a>00283 
<a name="l00284"></a>00284 <span class="keyword">private</span>:
<a name="l00285"></a>00285     <a class="code" href="class_c_camera_engine_private.html" title="Camera engine (implementation) class.">CCameraEnginePrivate</a>* iPimpl;
<a name="l00286"></a>00286   };
<a name="l00287"></a>00287 
<a name="l00288"></a>00288 <span class="preprocessor">#endif //CCAMERAENGINE_H</span>
</pre></div></div>
</div>
<!--- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&nbsp;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&nbsp;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&nbsp;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&nbsp;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&nbsp;</span>Enumerations</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<hr class="footer"/><address class="footer"><small>Generated on Sat Sep 11 2010 22:34:42 for Symbian/S60 Camera Wrapper Library by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>
